home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / symlink.man < prev    next >
Encoding:
Text File  |  1989-02-02  |  3.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SYMLINK               C Library Procedures                SYMLINK
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      symlink - make symbolic link to a file
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ssyymmlliinnkk((nnaammee11,, nnaammee22))
  13.      cchhaarr **nnaammee11,, **nnaammee22;;
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.      A symbolic link _n_a_m_e_2 is created to _n_a_m_e_1 (_n_a_m_e_2 is the name
  17.      of the file created, _n_a_m_e_1 is the string used in creating
  18.      the symbolic link).  Either name may be an arbitrary path
  19.      name; the files need not be on the same file system.
  20.  
  21. RREETTUURRNN VVAALLUUEE
  22.      Upon successful completion, a zero value is returned.  If an
  23.      error occurs, the error code is stored in _e_r_r_n_o and a -1
  24.      value is returned.
  25.  
  26. EERRRROORRSS
  27.      The symbolic link is made unless on or more of the following
  28.      are true:
  29.  
  30.      [ENOTDIR]      A component of the _n_a_m_e_2 prefix is not a
  31.                     directory.
  32.  
  33.      [EINVAL]       Either _n_a_m_e_1 or _n_a_m_e_2 contains a character
  34.                     with the high-order bit set.
  35.  
  36.      [ENAMETOOLONG] A component of either pathname exceeded 255
  37.                     characters, or the entire length of either
  38.                     path name exceeded 1023 characters.
  39.  
  40.      [ENOENT]       The named file does not exist.
  41.  
  42.      [EACCES]       A component of the _n_a_m_e_2 path prefix denies
  43.                     search permission.
  44.  
  45.      [ELOOP]        Too many symbolic links were encountered in
  46.                     translating the pathname.
  47.  
  48.      [EEXIST]       _N_a_m_e_2 already exists.
  49.  
  50.      [EIO]          An I/O error occurred while making the direc-
  51.                     tory entry for _n_a_m_e_2, or allocating the inode
  52.                     for _n_a_m_e_2, or writing out the link contents
  53.                     of _n_a_m_e_2.
  54.  
  55.      [EROFS]        The file _n_a_m_e_2 would reside on a read-only
  56.                     file system.
  57.  
  58.      [ENOSPC]       The directory in which the entry for the new
  59.                     symbolic link is being placed cannot be
  60.  
  61.  
  62.  
  63. Sprite v1.0              August 26, 1985                        1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SYMLINK               C Library Procedures                SYMLINK
  71.  
  72.  
  73.  
  74.                     extended because there is no space left on
  75.                     the file system containing the directory.
  76.  
  77.      [ENOSPC]       The new symbolic link cannot be created
  78.                     because there there is no space left on the
  79.                     file system that will contain the symbolic
  80.                     link.
  81.  
  82.      [ENOSPC]       There are no free inodes on the file system
  83.                     on which the symbolic link is being created.
  84.  
  85.      [EDQUOT]       The directory in which the entry for the new
  86.                     symbolic link is being placed cannot be
  87.                     extended because the user's quota of disk
  88.                     blocks on the file system containing the
  89.                     directory has been exhausted.
  90.  
  91.      [EDQUOT]       The new symbolic link cannot be created
  92.                     because the user's quota of disk blocks on
  93.                     the file system that will contain the sym-
  94.                     bolic link has been exhausted.
  95.  
  96.      [EDQUOT]       The user's quota of inodes on the file system
  97.                     on which the symbolic link is being created
  98.                     has been exhausted.
  99.  
  100.      [EIO]          An I/O error occurred while making the direc-
  101.                     tory entry or allocating the inode.
  102.  
  103.      [EFAULT]       _N_a_m_e_1 or _n_a_m_e_2 points outside the process's
  104.                     allocated address space.
  105.  
  106. SSEEEE AALLSSOO
  107.      link(2), ln(1), unlink(2)
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0              August 26, 1985                        2
  130.  
  131.  
  132.  
  133.